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Lesson 4: Member Types 


+ After successfully completing this lesson, you 
will be able to: 


+ Use the right kind of member in the right 
places 


+ Understand the trade-offs in using one kind 
of member instead of another 


Kinds of Members 


+ Classes and ValueTypes can have: 
+ Constructors 
+ Methods 
+ Fields (data members) 
+ Properties 
+ Events 


Constructors 


+ Do minimal work in the constructor 
+ Only capture the parameters 
+ Cost is delayed 
+ You can throw exceptions from constructors 


+ Be consistent in the ordering and naming of 
constructor parameters 


Constructors: Implicit Constructors 


+ Many languages automatically add a public 
default constructor if you don't specify any 


+ Abstract classes get a protected constructor 
+» These two code snippets are equivalent: 


public c 
publ 


$ 
J 


+ Always explicitly cee a 
avoid versioning 


+ Adding a new constructor remo 
default one, breaking clients 


public cla 


Ve f = new 
Publié cl 


public Foo (int valu 


Constructors and Properties 


A constructor's parameters are shortcuts for 

setting properties 

+ No difference in semantics between these 
code snippets: 


EventLog log = new EventLog(); 
log.MachineName = “kcwalinad"; 
log.Log "Security"; 


EventLog log new EventLo 


+ Use overloading only when the overloads do 
semantically the same thing 
+ Incorrect overload: 
String.Ind ing 


ring.Ind (char[] any 


+ Correct overload: 


ringCint valu 


vert. ToString (dou 


Method Overloading: Defaults 


+ Use appropriate default values 
+ Simple method assumes default state 


+ More complex methods indicate changes 
from the default state 


MethodInfo T: 
{igno 


MethodiInfo Ty thod (string name, 
boolean ig ); 


+» Use a zeroed state for the default value (such 
as: 0, 0.0, false, “”, etc.) 
a 


Method Overloadi ing: Example 


and naming 


paramı 
should be virtual if needed 


publ ic class Foo { 
private const string defaultForA = "a default"; 
private const int defaultForB = 42; 
public void BarQ{ 
Bar(defaultForA, defaultForB); 


} 
public void Bar (string a){ 
BarCa, defaul tForB) ; 


E 
public /*virtual*/ void Bar (string a, int b){ 
£f core implementation here 
4 
} 


Methods: Params 


+ Variable number of arguments (example: printf) 
+ Use params 


Methods: Performance 


+ Allowing method in-lining by the JIT\NGen: 
+ Minimize the use of virtual methods 
+ Don't write really large methods 
+ Don't have large numbers of locals 


Fields 


+ Avoid publicly exposed instance fields 


+ Properties offer more flexibility at minimal 
cost 


e JITANGEN inlines simple property access 
+ Easy to add cache or delay creation in the 
future 
+ For static fields, do not include a prefix on a 
public field mame 


+ Example: Te ‘or 's_' to distinguish static vs. 
non-static fields 


a 


Technica 


Const vs. Readonly 


t readonl 
Compile-time evaluation Run-time evaluation 
Stable across versions Unstable across versions 
Always static Static or instance 


class Math { 


} 


public const double Pi 


class Color { 


} 


public static readonly Color Red = new Color(...); 
public static readonly Color Blue new ColorC...);3 
public static readonly Color Green = new Color(...); 


Properties 
Smart fields 
+ Calling syntax like fields 
+ Flexibility of methods 


public class Button: Control { 
private string text; 
public string Text { 
get [ 
return text; 


set [ Button b new Button(); 
text = value; b. Text = "OK"; 
Repaint O; string s = b.Text; 


Properties 


+ Use read-only properties where appropriate 

+ Do not use write-only properties 

+ Consider raising PropertyChanged events 

+ Property getters should be simple and 
therefore unlikely to throw exceptions 

+ Properties should not have dependencies on 
each other 
+ Setting one property should not affect other 

properties 
+ Properties should be settable in any order A 


Technica | 


Properties 


Public class MyClass { 
private string name; 
public string Name { 

get { 
return name; 


+ 


protected void SetName (string name) 


{T 
+ 


this.name = name; 


Properties ys. Methods 


+ Do use a property: 
+ If the member has a logical data member 


Properties vs. Methods 
(continued) 
+ Do use a method: 


+ If the operation is a conversion, such as 
ToString() 


+ If the getter has an observable side effect 
+ If order of execution is important 
+ If the method might not return immediately 


+ Do use a method: (continued) 


+ If the member returns 


FillList( 
< Tl.Length; i++) { 


+» Creat 
through the 
+ The GetAl 1 () form makes this much clearer 


ap shot of the array each time 


+ Use if the bo 


» Almost alwa 


cal backing store 


object, int, or string indexed 
+ Rare to have multiple indices 


= "foo"; 


«Writeline (s[1]); // calls indexer 


+ Defining a 


public delegate void EventHandler(object sender, 
Eventargs e); 


public class Button: Control { 
public event EventHandler Click; 


protected void Onclick(Eventargs e) { 
if (click != null) 
Click(this, e); 


void Initialize() { 
Button b = new Button(...); 
b.Click += new EventHandler(ButtonClick); 


void ButtonClick(object sender, EventArgs e) 


t 


MessageBox.Show("You pressed the button"); 


Events 


` rompon Events are raised, not triggered or 
E 


- Name events with a verb 
» Example: Click, Paint, DrawItem, DropDown, 
+ Event handlers have void return type 


= Event handler delegates use a signature that follows 
the event design pattern 


Events 


+ Use strongly typed event data where 
appropriate 


+ Able to add new members without a breaking 
change 


Events 


Provide a protected method to raise the event 
+ Named On£ventiVíame 
Make it virtual if extensibility is needed 


public class Button { 
private ButtonclickHandler onclickHandler; 
protected void OnClick (ClickEventargs e) { 
if (onclickHandler != null) { 
/f call the delegate if non-null 


onclickHandler(this, e); 


protected void DoclickO £ 
PaintDown(); // paint button in dep 


try { 
OnclickO; // call event handler 
2 
finally { 
¿7 wind y be ete event handler 
if CwindowHandle 
PaintUpO; // paint button in normal state 


Static Members 


+ Any kind of member can be static 
+ Static members 

+ Cannot access instance state 

+ Cannot override or specialize 

+ Should be thread-safe 
+ Commonly used for 

+ Factory methods 

+ Singleton pattern 

+ Utility methods 


» Statics are the Microsoft® NET equivalent of global 
variables or global functions 


= Not object-oriented 
» Same evils as global 
+ But can be very useful 


stem.Math—full modeling not required 


public class Int 
publi tic int Parse (string 


Jue = new DBNuUT 


Singleton Pattern 


» Notice: 


+ This class is sealed to prevent sub-classing 
to add instances 


+ The Value is static for easy access 


+ The Value is read-only so it cannot be 
modified 


+ This class has a private constructor 
+ The instance is immutable 
+ No methods can mutate ¡ts state 


Parameter Passing 

+ Value types and reference types can both be 
passed by value or by reference 

+ A value type by value copies the value 
+ No side effects 


+ Commonly used 
public int Add (int x, int y) {..} 


+ A value type by reference uses a pointer to the 
value 
+ Side effects possible 
+ Can be hard to use—often avoidable 
public static int TryParse (string str, 
out int value) 


a 
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Parameter Passing (continued) 


+ Areference type by value copied the reference 
+ Side effects are possible on mutable types 


+ Commonly used 
public void Insert (object value) {..} 
+ A reference type by reference uses a pointer to the 
reference variable 
+ Side effects possible 


+ Almost never used 
public static int Method (ref object 
moreData) {..} 


Ref and Out Parameters 


+ Using Ref and Out parameters 
+ Primarily used for interop 
+ Avoid directly exposing publicly 


+ May be used for extremely perfor mance- 
sensitive areas 


+ Almost exclusively used with value types 
+ Ref is a common language runtime (CLR) feature 
+ Out is a C# feature 


+ Out parameter semantics downgrade to Ref 
semantics in other languages A 
Technical | 


public 
public int 


Argument Validation 


+ Do argument checking on every publicly 
exposed member 


+ Catches errors early (fail-fast) 

+ Much easier to debug 

+ Is a powerful security precaution 
+ Throw meaningful exceptions 

+ Subclasses of ArgumentExoeption 


public int Count { 
get {return count;} 
set { 
if (value < O || value >= MaxValue) 
throw new ArgumentException(..); 


} 


} 
public void Select (int start, int end) { 
if (start < 0) 
throw new ArgumentException(..); 
if (end < start) 
throw new ArgumentException(..); 


Exercise: Choose the Right 
Member 


+ A collection class needs a member 
to return the number of elements in 
the collection 


Technical 


Exercise: Choose the Right 
Member 


+ A data access class needs to 
express a user id, password, and 
connection string and a way to 
initiate a connection 


Technical 


Exercise: What's Wrong with This 


public class Student { 
public const int Retirement_Age = 60; 
public int Age; 
public string Getname O {} 
public Class this[int courseNumber] 
E get {...3 } 
public void Register (string className) [ 
Register (className, true); 
$ 
publ ic void Register (string className, 
bool waitList) {} 
public void Register Cint courseNumber) {} 
z à 


Technical 


Exercise: What's Wrong with This 
Member? 


public sealed class String { 
public static string Format (string formatString, 
object obj1) { 
return Format CformatString, obj1, mull); 


public static string Format (string formatString , 
object obj1, object obj2) { 
return Format (formatString, obj1, 
0b32, mull); 
H 


public static string Format (string formatString, 
object objl, object obj2, object obj3) { 
/f implementation 
y A 


Technical 


Exercise: What's Wrong with This 
Member? 


public class Convert { 
public string IntToString Cint value) {} 


public string DoubleToString (double value) 
{} 


Technical 


Lesson 4 Summary 


+ Use the right member at the right time, in the 
right way 


+ Constructors 
+ Methods 

+ Properties 

+ Fields 

+ Events 
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